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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill nopCommerce module. It assumes that you 
have an existing nopCommerce installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 

















Convention Description 

Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 

Glossary Glossary term 

Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the nopCommerce module? 
nopCommerce is an eCommerce platform, which provides online merchants with a flexible shopping 
cart system, as well as control over the look-and-feel, content, and functionality of their online store. 


nopCommerce has been fully integrated with Skrill’s online payment solution called Quick Checkout. 
Installing and configuring the Skrill Payment Solution module provides a simple, secure and convenient 
option for connecting to Skrill’s online payment processing platform via nopCommerce. 


Skrill customers using nopCommerce have access to a wide range of card and alternative payment 
methods. 


Signing up for a Skrill account 
Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your nopCommerce backend and start taking payments. 
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3. Installing and configuring nopCommerce 


Secret Word and API Password 

It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill nopCommerce module. The secret word is used to authenticate the data sent 
back to your nopCommerce server after payment. You must obtain the IP address of your 
nopCommerce server to configure the API/MQI password. You can find this IP address by executing 
the following command from a command prompt: 


ping <server domain name> 
For example: 


ping example. nopcommerceserver.com 
Pinging example. nopcommerceserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


Log in to your Skrill merchant account at www.skrill.com 


1 

2. Go to Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your nopCommerce 
server. This prevents payment or money transfer requests from other IP addresses if your 
secret word or API password is compromised. All requests from other IP addresses are 
denied. Access can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 

5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase letter, 
and 1 number. 
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Setting 


@ Developer Settings 
Configure API and security settings for your wallet account 
£ Transf 
Bla Bla Wallet 
fü Banking 1: 116404455 





Developer Settings : Bla Bla Wallet Il mm ES SIS BE. mu DI ba fo] E 25 mm 


Wallet IP Whitelisting API / MQ! / GSR / CVT Management API Documentation 


(© Automated Payment Interface (API) Disabled C» 


Allow requests to the API only from the following IP addresses. 








& Account Settings Your API secure IP addresses: ( 2 dh + ada) 








£33 Developer Settings 
87.120,141.129 


el Settings 


(0 Meca L) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQI secure IP addresses: + Add 


No active secure IP address found 





[E Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 


Your GSR secure IP addresses: 


[-] SetAPI/MQI Password Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


rine co 


E] SetSecret Word Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


Co e» 


kings | PrivacyNotice | Regulatory Disclosures | Cookie Notice 
[© 2020 Paysafe Holdings UK Limited. All rights reserved. Skrill® is a registered trademark of Paysafe Holdings UK Limited. Skrill Limited is registered in England and Wales with company number 04260907 and its registered office at 25 Canada Square, London E14 SLQ. Authorised and regulated by the Financial Conduct 





Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill on your nopCommerce backend 
The next stage of the nopCommerce integration is to configure the nopCommerce module to connect 
to your Skrill account. The steps are as follows: 


Login to your nopCommerce admin account 

. Goto Configuration 

Click on Payment methods 

If you have not downloaded Skrill, click on the marketplace (top left-hand side) 


TOW POE 
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5. Once Skrill is downloaded go to payment methods again 
6. Locate Skrill 
7. Press configure to insert your Skrill credentials (Figure 3-2) 
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For plugin configuration follow these steps: 


1. Create a merchant account at skrill.com 

2. Go to Settings > Developer Settings 

3. Please tick the box for MQI/API password to activate them. 

4. Add your server IP for the MQI and API 

5. Create MQI/API password. You must use a separate password from the one used for your Skrill Digital Wallet. This ensures that you can change your Skrill Digital Wallet account without affecting the API or MQI 
6. In the Secret Word field, create your secret word (should be minimum 8 characters, one digit or one special character) 

7. To apply your changes, click Save 

8. Please copy your secret word and API/MQI password into the below shown fields 

9. Save 


Payment flow @ On the Merchant side v 
Merchant email @ SkrillPaymentHB3@skrill.com 
Secret word Q seess. 
API/MQI password Q ——— 


Figure 3-2: Skrill Settings with example values in nopCommerce backend 


Configure Skrill Settings 
Configure the Skrill Settings as follows: 


1. Enter your Skrill Merchant account email address 

2. Enterthe API password and Secret word that you set up in the previoussection 

3. Select a display option for the Skrill Payment Form (Iframe or redirect). See Table 3-1 below 
for a detailed explanation of all Skrill settings 
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Table 3-1: Skrill Settings 





Field Name 


Description 


Format/ Example 





Merchant 
Account (email) 


The email address linked to your Skrill merchant 
account (created by you when you first signed up 
for a Skrill merchant account). 


techpubs@skrill.com 





API Password 


The API password. This field is mandatory. It 
allows the nopCommerce server to receive 
payment information. 


N/A 





Secret word 


Enter the secret word configured for your Skrill 
account here. This feature is mandatory and 
ensures the integrity of the data posted back to 
your nopCommerceservers. 


N/A 





Display 








This setting has two options: IFrame and Redirect 


e IFrame - when IFrame is enabled the Skrill 
Payment Form is embedded in your shop 
Website. See Figure 3-3: for anexample. 


* Redirect - when redirect is enabled the 
customer is redirected to the Skrill Payment 
Form. This form is displayed on its own in 
the current browser tab. This option is 
recommended if you plan to display 
Payment Methods which redirect the user 
to an external website such as Klarna, 
Rapid Transfer, etc. 





IFrame 





10 
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&® English Germany 
Your store 
1 . 1 Gusp o name 


Skrill =)) come QD 


Card number 


Expiry date Security code 
MM | YY CVV 


Cardholder name 


Type the name exactly as it appears on the card 


PAY NOW 


— Powered by 
Or= Skrill 


Figure 3-3: Iframe (embedded) option 
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4. Customer Experience 


This section describes the customer's checkout experience when using the Skrill nopCommerce module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 
steps are unchanged. 


The steps are as follows: 


1. Click on Skrill, to open up the Skrill gateway with all local payment options available for the 
customers country 


Checkout 


1 Biling address 


Shipping address 


3 Shipping method 
4 Payment method 


CONTINUE 


Figure 4-1: nopCommerce Checkout Payment selection showing different payment methods 
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2. Enter Payment details in the Skrill Payment Form. 


@ English Germany 
Your store 
1 . 1 Guso o name 


Skrill =p we Q 


Card number 


Expiry date Security code 


MM | YY CVV EP 


Cardholder name 


Type the name exactly as it appears on the card 


PAY NOW 


Norton pr + 
ge Skrill 


Figure 4-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display 
the following screen: 


&» English United Kingdom 


1. 16usp D Taree 


d 





Successful payment 


= e 
Ge Skrill 
Figure 4-3: Successful Payment 


4. Click Continue to return to the nopCommerce order confirmation screen 





4 | Confirm order 


Billing Address 

Customer fdfdsa 

Email: customer451@gmail.com 
Phone: 000000000000 

Fax: 

High Street 

London,E1 7YT 

United Kingdom 


Payment 
Payment Method: Skrill 


SKU Image Product(s) Price Qty. Total 
IF YOU WT If You Wait (donation) €1.00 1 €1.00 
Sub-Total: €1.00 
Shipping: Not required 
Tax: €0.00 
Total: €1.00 


Figure 4-4: Order Confirmation in Prestashop Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 


© English France 
10.00: 
o 5 
@ Engitsh France © English France 
-— — 
— © =| 9 = @ 
— © 
visa SD 
visa SD wa e 

Expiry date Security code Expiry date Security code 

MM YY cw m aaa II ae Em — Expiry date Security code 

MM | YY ov Nm 

Cerdholder name Cardholder name 

First Last First Last Cardholder name 

First Last 
Email address Why? Email address Why? 
Email address Why? 
PAY NOW 
Peaeed ty Powered ty 
v Skrill v*- Skrill Powered by Skrill 


Figure 4-5: Reduced Header and Footer Option 
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5. Payment Information 


The Payment Information section includes the following information shown in order: 


1. The payment option selected in the nopCommerce Checkout 


2. The payment status 

3. The country the payment order originated from. This information is obtained by Geolocation 
using the Customer's IP address 

4. The currency the order was placed 


Update Order 

The Payment Information section also contains an Update Order button. This button is used to check 
an order's payment status with the Skrill Payment Platform and re-send a status update. The payment 
information is then updated. This feature is useful if your nopCommerce server goes offline or if there 
is a technical fault with Skrill's servers which prevents payment status updates being sent or received. 


Refunding Payments 


From your nopCommerce backend you can complete full or partial refund. The process for Refunding 
customer payments is as follows: 


1. Goto Sales in the nopCommerce Admin Panel 
2. Follow to Orders 


3. Search for the customer's invoice 


Orders [B PrintPDFinvoices | ~ 
Q Search v 
Start date () e Vendor @ All v 
End date (9 [us] Billing phone number @ 
Warehouse @ All v Billing email address €) 
Product @ Billing last name @ 
Order statuses @ All X Billing country @ All v 
Payment statuses @ All X Payment method @ All v 
Shipping statuses @ All X Order notes @ 
Go directly to order & @ 
Order # Order status Payment status Shipping status Customer Created on Order total View 
Paid Shipping not required customer451@gmail.com 08/21/202001:19:20 $1.16 ®© View 


Figure 5-1: Search for Order 
4. Click view on the Order you want to refund 


5. Check that the details are correct 
6. Select Refund from the menu 
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Order subtotal (9 
Order shipping © 
Order tax © 
Order total © 


Profit © 


Payment method @ 


Payment status @ 
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$1.16 excl tax 
$0.00 excl tax 
$0.00 
$1.16 


$1.16 


Edit order totals 


Check / Money Order 
Paid 


Refund (Offline) Partial refund (Offline) 


Figure 5-2: Refund Payment 
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Order subtotal © 
Order shipping @ 
Order tax © 

Order total © 
Refunded amount (9 


Profit O 


Payment method (3 


Payment status © 
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$1.16 excl tax 
$0.00 excl tax 
$0.00 
$1.16 
$1.16 


$0.00 


Edit order totals 


Check / Money Order 


Refunded 


Figure 5-3: Refunded Payment 


18 


Skrill nopCommerce Module Configuration Guide 


6. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 


Table 6-1: Test Cards 














Brand Card Number 
MasterCard 5438311234567890 
Visa 4000001234567890 











Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness(9 paysafe.com, so we can provide you with access. 
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